NAVNavbar
Logo
cURL php NodeJS Python cSharp

Get Advanced Google Hotel Info Results by id

 

Advanced Google Hotel Info will provide you with structured data available for a specific hotel entity on the Google Hotels platform: such as service description, location details, rating, amenities, reviews, images, prices, and more.

The returned results are specific to the indicated hotel_identifier, location and language parameters. We emulate all the parameters with the highest accuracy so that the results you receive will match the actual search results for the specified parameters at the time of task setting. You can always check the returned results accessing the check_url in the Incognito mode to make sure the received data is accurate.

Instead of ‘login’ and ‘password’ use your credentials from https://app.dataforseo.com/api-dashboard

<?php
// You can download this file from here https://cdn.dataforseo.com/v3/examples/php/php_RestClient.zip
require('RestClient.php');
$api_url = 'https://api.dataforseo.com/';
// Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-dashboard
$client = new RestClient($api_url, null, 'login', 'password');

try {
	$result = array();
	// #1 - using this method you can get a list of completed tasks
	// GET /v3/business_data/google/hotel_info/tasks_ready
	$tasks_ready = $client->get('/v3/business_data/google/hotel_info/tasks_ready');
	// you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors
	if (isset($tasks_ready['status_code']) AND $tasks_ready['status_code'] === 20000) {
		foreach ($tasks_ready['tasks'] as $task) {
			if (isset($task['result'])) {
				foreach ($task['result'] as $task_ready) {
					// #2 - using this method you can get results of each completed task
					// GET /v3/business_data/google/hotel_info/task_get/advanced/$id
					if (isset($task_ready['endpoint'])) {
						$result[] = $client->get($task_ready['endpoint']);
					}
					// #3 - another way to get the task results by id
					// GET /v3/business_data/google/hotel_info/task_get/advanced/$id
					/*
					if (isset($task_ready['id'])) {
						$result[] = $client->get('/v3/business_data/google/hotel_info/task_get/advanced' . $task_ready['id']);
					}
					*/
				}
			}
		}
	}
	print_r($result);
	// do something with result
} catch (RestClientException $e) {
	echo "n";
	print "HTTP code: {$e->getHttpCode()}n";
	print "Error code: {$e->getCode()}n";
	print "Message: {$e->getMessage()}n";
	print  $e->getTraceAsString();
	echo "n";
}
$client = null;
?>

The above command returns JSON structured like this:

{
    "version": "0.1.20210519",
    "status_code": 20000,
    "status_message": "Ok.",
    "time": "0.0852 sec.",
    "cost": 0,
    "tasks_count": 1,
    "tasks_error": 0,
    "tasks": [
        {
            "id": "05241527-1535-0282-0000-5119689c8020",
            "status_code": 20000,
            "status_message": "Ok.",
            "time": "0.0298 sec.",
            "cost": 0,
            "result_count": 1,
            "path": [
                "v3",
                "business_data",
                "google",
                "hotel_info",
                "task_get",
                "advanced",
                "05241527-1535-0282-0000-5119689c8020"
            ],
            "data": {
                "se_type": "hotel_info",
                "se": "google",
                "api": "business_data",
                "function": "hotel_info",
                "hotel_identifier": "CgoI-KWyzenM_MV3EAE",
                "location_code": 1023191,
                "language_code": "en",
                "device": "desktop",
                "os": "windows"
            },
            "result": [
                {
                    "hotel_identifier": "CgoI-KWyzenM_MV3EAE",
                    "location_code": 1023191,
                    "language_code": "en",
                    "check_url": "https://www.google.com/travel/hotels/entity/CgoI-KWyzenM_MV3EAE?hl=en&gl=US&gws_rd=cr&uule=w+CAIQIFISCTsIP9OlT8KJEWL-d-EGjwvI&ts=CAESCAoCCAMKAggDGjcKGRIVOhNDZ29JLUtXeXplbk1fTVYzRUFFGgASGhIUCgcI5Q8QBRgZEgcI5Q8QBRgaGAEyAhAAKg8KCygBSgIgAToDVVNEGgA",
                    "datetime": "2021-05-24 12:27:54 +00:00",
                    "title": "Wildwood Suites",
                    "stars": 3,
                    "stars_description": "3-star hotel",
                    "address": "120 Sawmill Rd, Breckenridge, CO 80424",
                    "phone": "+19705474800",
                    "about": {
                        "description": "Homey 1- & 2-bedroom ski-in/ski-out condos with kitchens in a hotel offering an outdoor hot tub.",
                        "sub_descriptions": [
                            "Next to the 4 O’Clock Ski Run of the Breckenridge Ski Resort, this relaxed condo hotel is 2 miles from the Imperial Express ski lift.",
                            "Offering ski-in/ski-out access, the casual 1- and 2-bedroom condos have a warm vibe, and feature free Wi-Fi and flat-screen TVs, as well as and kitchens, living areas and balconies or patios. Some duplex units have spiral stairs.",
                            "Parking is complimentary. There's also an outdoor hot tub, and a spa area with a sauna. Massage services are available."
                        ],
                        "check_in_time": {
                            "hour": 16,
                            "minute": 0
                        },
                        "check_out_time": {
                            "hour": 11,
                            "minute": 0
                        },
                        "full_address": "Wildwood Suites, 120 Sawmill Rd, Breckenridge, CO 80424",
                        "domain": "www.breckenridgeresortmanagers.com",
                        "url": "https://www.breckenridgeresortmanagers.com/vacation-rentals/breckenridge-complex/wildwood-suites-lodge",
                        "amenities": [
                            {
                                "category": "policies_and_payments",
                                "category_label": "Policies & payments",
                                "items": [
                                    {
                                        "amenity": "smoke_free_property",
                                        "amenity_label": "Smoke-free property",
                                        "hint": null,
                                        "hint_label": null
                                    }
                                ]
                            },
                            {
                                "category": "children",
                                "category_label": "Children",
                                "items": [
                                    {
                                        "amenity": "kid_friendly",
                                        "amenity_label": "Kid-friendly",
                                        "hint": null,
                                        "hint_label": null
                                    }
                                ]
                            },
                            {
                                "category": "pools",
                                "category_label": "Pools",
                                "items": [
                                    {
                                        "amenity": "hot_tub",
                                        "amenity_label": "Hot tub",
                                        "hint": null,
                                        "hint_label": null
                                    }
                                ]
                            },
                            {
                                "category": "parking_and_transportation",
                                "category_label": "Parking & transportation",
                                "items": [
                                    {
                                        "amenity": "parking",
                                        "amenity_label": "Parking",
                                        "hint": "free",
                                        "hint_label": "Free"
                                    }
                                ]
                            },
                            {
                                "category": "wellness",
                                "category_label": "Wellness",
                                "items": [
                                    {
                                        "amenity": "fitness_center",
                                        "amenity_label": "Fitness center",
                                        "hint": null,
                                        "hint_label": null
                                    }
                                ]
                            },
                            {
                                "category": "pets",
                                "category_label": "Pets",
                                "items": [
                                    {
                                        "amenity": "pets_allowed",
                                        "amenity_label": "Pets allowed",
                                        "hint": null,
                                        "hint_label": null
                                    }
                                ]
                            },
                            {
                                "category": "rooms",
                                "category_label": "Rooms",
                                "items": [
                                    {
                                        "amenity": "kitchen",
                                        "amenity_label": "Kitchen",
                                        "hint": null,
                                        "hint_label": null
                                    }
                                ]
                            }
                        ],
                        "popular_amenities": [
                            {
                                "amenity": "parking",
                                "amenity_label": "Parking",
                                "hint": "free",
                                "hint_label": "Free"
                            },
                            {
                                "amenity": "hot_tub",
                                "amenity_label": "Hot tub",
                                "hint": null,
                                "hint_label": null
                            }
                        ]
                    },
                    "location": {
                        "neighborhood": "",
                        "neighborhood_description": null,
                        "maps_url": "https://maps.google.com/maps?hl=en&gl=US&um=1&ie=UTF-8&fb=1&sa=X&ll=39.4806397,-106.0512973&z=15&ftid=0x0:0x778bf26699ac92f8&q=Wildwood+Suites",
                        "overall_score": 4.6,
                        "score_by_categories": {
                            "overall": 4.6,
                            "things_to_do": 4.8,
                            "restaurants": 4.5,
                            "transit": 4.9,
                            "airport_access": 1.9
                        },
                        "latitude": 39.4806397,
                        "longitude": -106.0512973,
                        "location_chain": [
                            {
                                "card_id": "/m/01n4w",
                                "feature_id": "0x874014749b1856b7:0xc75483314990a7ff",
                                "cid": "14363249359302207487",
                                "title": "Colorado"
                            },
                            {
                                "card_id": "/m/02b5n3",
                                "feature_id": "0x874722b914927c95:0x63217f66b7efe26",
                                "cid": "446445660195978790",
                                "title": "Colorado Western Slope"
                            },
                            {
                                "card_id": "/m/0rcrt",
                                "feature_id": "0x876af63d6c26e7c1:0x628d8f7f6680a27a",
                                "cid": "7101489964776465018",
                                "title": "Breckenridge"
                            },
                            {
                                "card_id": null,
                                "feature_id": "0x876af66539cef5ff:0x778bf26699ac92f8",
                                "cid": "8614245234755015416",
                                "title": "Wildwood Suites"
                            }
                        ]
                    },
                    "reviews": {
                        "value": 4.3,
                        "votes_count": 73,
                        "mentions": [
                            {
                                "title": "Location",
                                "positive_score": 0.5201218,
                                "positive_count": 20,
                                "negative_count": 2,
                                "total_count": 25,
                                "visible_by_default": true
                            },
                            {
                                "title": "Pets",
                                "positive_score": 0,
                                "positive_count": 4,
                                "negative_count": 0,
                                "total_count": 5,
                                "visible_by_default": true
                            },
                            {
                                "title": "Property",
                                "positive_score": 0.61387336,
                                "positive_count": 14,
                                "negative_count": 2,
                                "total_count": 18,
                                "visible_by_default": true
                            },
                            {
                                "title": "Accessibility",
                                "positive_score": 0,
                                "positive_count": 5,
                                "negative_count": 1,
                                "total_count": 7,
                                "visible_by_default": true
                            },
                            {
                                "title": "Nature",
                                "positive_score": 0,
                                "positive_count": 7,
                                "negative_count": 1,
                                "total_count": 9,
                                "visible_by_default": true
                            },
                            {
                                "title": "Service",
                                "positive_score": 0,
                                "positive_count": 6,
                                "negative_count": 2,
                                "total_count": 9,
                                "visible_by_default": true
                            },
                            {
                                "title": "Bathroom",
                                "positive_score": 0,
                                "positive_count": 4,
                                "negative_count": 4,
                                "total_count": 8,
                                "visible_by_default": true
                            },
                            {
                                "title": "Kitchen",
                                "positive_score": 0,
                                "positive_count": 4,
                                "negative_count": 1,
                                "total_count": 5,
                                "visible_by_default": true
                            },
                            {
                                "title": "Sleep",
                                "positive_score": 0,
                                "positive_count": 2,
                                "negative_count": 4,
                                "total_count": 7,
                                "visible_by_default": true
                            },
                            {
                                "title": "Cleanliness",
                                "positive_score": 0,
                                "positive_count": 5,
                                "negative_count": 0,
                                "total_count": 6,
                                "visible_by_default": false
                            }
                        ],
                        "rating_distribution": {
                            "5": 47,
                            "4": 41,
                            "3": 10,
                            "2": 0,
                            "1": 2
                        },
                        "other_sites_reviews": [
                            {
                                "title": "Priceline",
                                "url": "http://www.priceline.com/r/?channel=meta&product=hotel&theme=reviews&refid=PLGOOGLEHARV&refclickid=HARV_3850305&hotel_id=3850305",
                                "review_text": "Cute room . Kitchen very well stocked. Room was small but perfectly fine for myself/ husband/ and 2 young kids. Nice balcony view. Comfortable sofa couch. Would stay here again!",
                                "rating": {
                                    "rating_type": "CustomMax",
                                    "value": 7.7,
                                    "votes_count": 17,
                                    "rating_max": 10
                                }
                            },
                            {
                                "title": "Hotels.com",
                                "url": "https://www.hotels.com/ho481583/?q-check-out=2021-05-26&q-check-in=2021-05-25&q-room-0-adults=&rffrid=sem.hcom.US.156.017.02.localuniversal.02.desktop#reviews",
                                "review_text": "Location was perfect! The place was close to slopes and downtown walking to shops and dinner.. the beds were not great... and hard to regulate the heat...will stay again",
                                "rating": {
                                    "rating_type": "CustomMax",
                                    "value": 8,
                                    "votes_count": 19,
                                    "rating_max": 10
                                }
                            },
                            {
                                "title": "Expedia.com",
                                "url": "https://www.expedia.com/h15950.Hotel-Information?chkin=05/25/2021&chkout=05/26/2021&MDPCID=US.META.HPA.localuniversal-REVIEWS.HOTEL.desktop&mdpdtl=GGMETA.US.15950.20210525.20210526&mctc=10#section-reviews",
                                "review_text": "The bed was very uncomfortable along with the pillows, hurt my ears. Tried the pull out sofa instead this wasn't any better. We were to leave on Sunday but chose to leave on Saturday due to very little sleep.",
                                "rating": {
                                    "rating_type": "Max5",
                                    "value": 4.0602407,
                                    "votes_count": 83,
                                    "rating_max": null
                                }
                            },
                            {
                                "title": "Travelocity.com",
                                "url": "https://www.travelocity.com/h15950.Hotel-Information?chkin=05/25/2021&chkout=05/26/2021&MDPCID=TRAVELOCITY-US.META.HPA.localuniversal-REVIEWS.HOTEL.desktop&mdpdtl=GGMETA.US.15950.20210525.20210526&mctc=10#section-reviews",
                                "review_text": "What a great place to stay!I loved how close it was to town. We could walk to great shopping and dining. Would definitely stay here again!",
                                "rating": {
                                    "rating_type": "Max5",
                                    "value": 4.0602407,
                                    "votes_count": 83,
                                    "rating_max": null
                                }
                            },
                            {
                                "title": "Orbitz.com",
                                "url": "https://www.orbitz.com/h15950.Hotel-Information?chkin=05/25/2021&chkout=05/26/2021&MDPCID=ORBITZ-US.META.HPA.localuniversal-REVIEWS.HOTEL.desktop&mdpdtl=GGMETA.US.15950.20210525.20210526&mctc=10#section-reviews",
                                "review_text": "The room was clean and had all of the required appointments, however the bed was not comfortable and we opted to sleep on the hide-a-bed in the living room. We will not stay there again.",
                                "rating": {
                                    "rating_type": "Max5",
                                    "value": 4.0602407,
                                    "votes_count": 83,
                                    "rating_max": null
                                }
                            }
                        ]
                    },
                    "overview_images": [
                        "https://lh5.googleusercontent.com/p/AF1QipNOg1SbjmpLFV72xKE7UPKVEqjnc0NKzla3jrUw=w592-h404-n-k-no-v1",
                        "https://lh3.googleusercontent.com/proxy/VRe96Pw8jCLM4fP8VlLS-WPek6UXqm3wRIUouJ253KnRRyAxS6ZdI8U11wJi2GCkh-HcQBowCzHSol8wby4YijPw-RUcpS1auNyyjJhxequOI5ACrWZ5Nmeybr-TvRm8NeTfCvoSkACv_8ys9iqiuMyVr8pOZA=w592-h404-n-k-no-v1",
                        "https://lh6.googleusercontent.com/proxy/k_qHyVmER9FIwABOHsaV6ePaicRGAsbukH_mA3TtkHZieZTg1unOdUanFt3HkCpUP4LsRhkbmbNzI6_ZrGveGltAvjWwoM0OeSiNWLfqL4gCL15_y_kpY3aRlsEM65gOPFe8xWSjiPgNMi3mv-j6euT-vgTWxA=w592-h404-n-k-no-v1",
                        "https://lh5.googleusercontent.com/p/AF1QipNft-tXaoio1YhftYyUl5LfBL5JYzw5CagVhn8Y=w592-h404-n-k-no-v1",
                        "https://lh5.googleusercontent.com/p/AF1QipMw-_hA8zLOy5AAYCRgxMb35uls2OOHiz4NjRnB=w592-h404-n-k-no-v1",
                        "https://lh6.googleusercontent.com/proxy/1NW-9c102eV53pffn_9NDnlHRwDFo1avQVsr2wBRWnR_e7TBPQu8NfglLYdbbY1sLZGqOrEn6iGZzHCCc0Yos1ifssxF0516Z-o_biW5XJRTjegPC3jZ6h2QqwqUw2q1AZXcFWiZSMiDzOUe2Y5HMHnUkGgxqns=w592-h404-n-k-no-v1",
                        "https://lh3.googleusercontent.com/proxy/MzAMQaEMQ1zo2jR35ilZah0P7EGiibcbgFRPvrdGrIgYQon23s6WOJO3EM8jjuNdZfF4r3td-ub4ybk5qZ9jopWhAKd4z8G3bty7HscQPo9KwaK_LB2sLPaSW9NGPrjjxhUD5nUckokqBLmbg8mi5S-POwaI1w=w592-h404-n-k-no-v1",
                        "https://lh4.googleusercontent.com/proxy/gQxCAIgJtafGbTVEppNaEvcncen1dPZohP9cWkKLYUSCt0gM9qEYxETuGFWGaYu8Pvkgvzy_rrgEiFV2n7SrnJdlf_TZueIcBh6WXzKqIL0JZW5Pk_bXVq9qXnMA57LbW8MiVg5fHXFIaux4tOC4ckdjQwdnVg=w592-h404-n-k-no-v1",
                        "https://lh6.googleusercontent.com/proxy/Dz2DQlVyp_5HVZPulu5L7C0u33Dijpi6tI9sNWnN-2zW4WDuEvFZrGYWtvEWWpkBlj8NJB3kxNWBr4N_zJrIkcgU154P71zUw_ygY2hfm6qplqXoV7N2dqhjXA_ETJAN3JRUQDYr_XhpHTy1yfxsqf1IpX4HZCE=w592-h404-n-k-no-v1"
                    ],
                    "prices": {
                        "price": 91,
                        "price_without_discount": null,
                        "currency": "USD",
                        "discount_text": null,
                        "check_in": "2021-05-25 00:00:00 +00:00",
                        "check_out": "2021-05-26 00:00:00 +00:00",
                        "visitors": 2,
                        "items": [
                            {
                                "type": "hotel_info_price",
                                "title": "Priceline",
                                "price": 91,
                                "currency": "USD",
                                "url": "https://www.priceline.com/r/?channel=meta&product=hotel&theme=ghalistings&refid=PLGOOGLEMSS&refclickid=US_HP%7C3850305_localuniversal_1%7C20210525%7Cdesktop%7Cdefaultdate|public|1727673987||1%7C2%7C0|1&hotelid=3850305&checkin=20210525&checkout=20210526&rooms=1¤cy=USD&displayedCurr=USD&pOSCountryCode=US&taxDisplayMode=BP&cityid=3000002533&adults=2&land=L&metaid=AQ4IyJu_1dhNafoWk3dtxokLmsNOmpJsEsccgnegzgZFuZRbiZtsVZBU1PkudCunQv5EBubTEw1Ny8HNp6LF6WzZaE8CaPFTqOGD1PFrJyRXjelowXNF-A-ZTfx0axj3_JDHA8BzkRykI4qDtwN6jbsw9z0xngUUdL-rZ2826lQGo8LqxWJontlO4OBEJANLyOJAiJDDWgUCwpFMz_13eyUgpe2_vGSTsgolwbHO6x83RwsfYsHgN0U68HlcaMVs&dblcnt=true&user_num_adults=2",
                                "domain": "www.priceline.com",
                                "is_paid": true,
                                "free_cancellation_until": null,
                                "offers": [
                                    {
                                        "type": "hotel_info_price_offer",
                                        "title": "One Bedroom Apartment - Non-Refundable",
                                        "price": 91,
                                        "currency": "USD",
                                        "url": "https://www.priceline.com/r/?channel=meta&product=hotel&theme=ghalistings&refid=PLGOOGLEMSS&refclickid=US_HP%7C3850305_localuniversal_1%7C20210525%7Cdesktop%7Cdefaultdate|public|1727673987||1%7C2%7C0|1&hotelid=3850305&checkin=20210525&checkout=20210526&rooms=1¤cy=USD&displayedCurr=USD&pOSCountryCode=US&taxDisplayMode=BP&cityid=3000002533&adults=2&land=L&metaid=AQ4IyJu_1dhNafoWk3dtxokLmsNOmpJsEsccgnegzgZFuZRbiZtsVZBU1PkudCunQv5EBubTEw1Ny8HNp6LF6WzZaE8CaPFTqOGD1PFrJyRXjelowXNF-A-ZTfx0axj3_JDHA8BzkRykI4qDtwN6jbsw9z0xngUUdL-rZ2826lQGo8LqxWJontlO4OBEJANLyOJAiJDDWgUCwpFMz_13eyUgpe2_vGSTsgolwbHO6x83RwsfYsHgN0U68HlcaMVs&dblcnt=true&user_num_adults=2",
                                        "max_visitors": 2,
                                        "offer_images": [],
                                        "free_cancellation_until": null
                                    },
                                    {
                                        "type": "hotel_info_price_offer",
                                        "title": "Two Bedroom Apartment  - Non-Refundable",
                                        "price": 96,
                                        "currency": "USD",
                                        "url": "https://www.priceline.com/r/?channel=meta&product=hotel&theme=ghalistings&refid=PLGOOGLEMSS&refclickid=US_HP%7C3850305_localuniversal_1%7C20210525%7Cdesktop%7Cdefaultdate|public|1727673987||1%7C2%7C0|1&hotelid=3850305&checkin=20210525&checkout=20210526&rooms=1¤cy=USD&displayedCurr=USD&pOSCountryCode=US&taxDisplayMode=BP&cityid=3000002533&adults=2&land=L&metaid=M40zFA1CCGM-IxxIq44e3CUWqlD5a0z6KkDU5tzVWhM0fUNdsuN00r2L67R7z7vMB_VgR8PT-eLKxleD4RMGjfh8q8xXmoTaVm0AZXEXgtGBahyrUAxwUci8-Kp9YWta9IVPAjO48FsyZ13Pbc4Lm2cFjW2ZnZwO3A15MjLxgvywYm9arDAfqPt8KODtGUCdnh3KA0xWZnrZkpdkLivYv9kNoRi663JsEef_xRbLXsCc9Jrf0NnLhzAOgYHLXJxJ&dblcnt=true&user_num_adults=2",
                                        "max_visitors": 2,
                                        "offer_images": [],
                                        "free_cancellation_until": null
                                    }
                                ]
                            },
                            {
                                "type": "hotel_info_price",
                                "title": "Tripadvisor.com",
                                "price": 91,
                                "currency": "USD",
                                "url": "https://www.tripadvisor.com/Hotel_Review-s1-?geo=1&detail=82829&m=35972&staydates=2021_05_25_2021_05_26&uguests=1_2&supdv=desktop&supbl=localuniversal&supkl=default&supuc=US&supul=en&supia=1&supip=0&supmb=&supmc=xbr2MCO9M6dsSx2MABQCxBRh1ricQaWMxp4vC-32XxXsoZ8V-uhpU48-0HCKPV7hihtPRDseH7vaY-t_8qEvsuSdff2x1HbLy0hj-pl__NnAxoPl5EIWAyTnBvqR65ErEbt5Zk1JYQ4nCoRy88A&supts=jkiI5q5Aa7rPuwZiABQCxBRh1ricQaWMxp4vC-32XxXsoUInCbSoHI5xZzZy5Y5Ib69zmZfc9kW_CZzHzezw7gXRcNtrhdCTduPvRKdyNdyldmBbXgxnqkRm20gO0AJT6rShVLHoXCijZly9YJiHe1YxiVUl1rxb_ig1uLenjb8F&supey=m|111939|PL_G_query&supcd=6455439320&suptp=CJus9t_rlub_jkIRABQCxBRh1ricQaWMxp4vC-32XxXsoXvklfs_oTFWAi9ms7zCdCiq_6DuCrQ-tlv-JaZfS_zWgcVdTPK5mbmSk-O9L0Rrvp6n7bxXo5I6iuu0dyM9eX59nt3wcUb5LasP5ZTa6RqokbNbTieSxTl_NTwwm-qlt2U&gclid={gclid}",
                                "domain": "www.tripadvisor.com",
                                "is_paid": true,
                                "free_cancellation_until": null,
                                "offers": null
                            },
                            {
                                "type": "hotel_info_price",
                                "title": "Agoda",
                                "price": 91,
                                "currency": "USD",
                                "url": "https://www.agoda.com/partners/partnersearch.aspx?site_id=1731665&CkInDay=25&CkInMonth=05&CkInYear=2021&CkOutDay=26&campaignid=13226672775&CkOutMonth=05&CkOutYear=2021&SearchDateType=default&NumberOfAdults=2<=1&NumberOfChildren=0&childages=&NumberOfRooms=1&gsite=localuniversal&los=1&PartnerCurrency=USD&hid=679639&RoomID=3008150&PriceTax=123.77&PriceTotal=214.77&RatePlan=d14ff656-5f64-c75b-3c80-2488610d9eb2&UserCountry=US&Currency=USD&UserDevice=desktop&Verif=false&rr=&audience_list=&mcid=3038&booking_source=cpc&adType=1",
                                "domain": "www.agoda.com",
                                "is_paid": true,
                                "free_cancellation_until": null,
                                "offers": [
                                    {
                                        "type": "hotel_info_price_offer",
                                        "title": "One Bedroom Apartment",
                                        "price": 91,
                                        "currency": "USD",
                                        "url": "https://www.agoda.com/partners/partnersearch.aspx?site_id=1731665&CkInDay=25&CkInMonth=05&CkInYear=2021&CkOutDay=26&campaignid=13226672775&CkOutMonth=05&CkOutYear=2021&SearchDateType=default&NumberOfAdults=4<=1&NumberOfChildren=0&childages=&NumberOfRooms=1&gsite=localuniversal&los=1&PartnerCurrency=USD&hid=679639&RoomID=3008150&PriceTax=123.77&PriceTotal=214.77&RatePlan=d14ff656-5f64-c75b-3c80-2488610d9eb2&UserCountry=US&Currency=USD&UserDevice=desktop&Verif=false&rr=&audience_list=&mcid=3038&booking_source=cpc&adType=1",
                                        "max_visitors": 4,
                                        "offer_images": [
                                            "https://lh3.googleusercontent.com/hrppk/ADiXZrGK1tJhPRww2lNO0dkBlpvnKbmTUI2Bm9_jTqq7B2pIk5LgTZumZBv2KzxifuAebKcxrOVWHZlqRBnfaJVLLCjUiWo4ajmwPJVp_lkZ0KOL3YNrmTasNxx-Y0O4OeFf1Hx5gL2KVX4qKC6RLuAgsUEuoliYVzr845HrVx1SX8i-pv-NYONoCfiP0C_Z6NnkyR8ymggYjjrF4oXpY72g0QwK4F80CLwu73o"
                                        ],
                                        "free_cancellation_until": null
                                    },
                                    {
                                        "type": "hotel_info_price_offer",
                                        "title": "Two Bedroom Apartment ",
                                        "price": 96,
                                        "currency": "USD",
                                        "url": "https://www.agoda.com/partners/partnersearch.aspx?site_id=1731665&CkInDay=25&CkInMonth=05&CkInYear=2021&CkOutDay=26&campaignid=13226672775&CkOutMonth=05&CkOutYear=2021&SearchDateType=default&NumberOfAdults=4<=1&NumberOfChildren=0&childages=&NumberOfRooms=1&gsite=localuniversal&los=1&PartnerCurrency=USD&hid=679639&RoomID=3008009&PriceTax=184.83&PriceTotal=280.83&RatePlan=a369a12c-f712-374d-ba65-9e0607b43719&UserCountry=US&Currency=USD&UserDevice=desktop&Verif=false&rr=&audience_list=&mcid=3038&booking_source=cpc&adType=1",
                                        "max_visitors": 4,
                                        "offer_images": [
                                            "https://lh3.googleusercontent.com/hrppk/ADiXZrHXQ2QkB6TIU5jfiicKUPiG0MWIeTyIK22-OemFcECzAb4Tj0d78mRoIboKHPSDRm0Qu6m_1u56dukurU9EsOTFGhBELmXFydaA2cACqAbQQwcbaxl8cU21-g6phlS2dW0LekUsck1eJ-z4FcjEKGEePgJ_kHNqIgaFry50oocfBLJDZ2FcwZgGaVhfJVJOqGfTcaNMXJDelzHuTtwCCa96iMNaWB7if5nY"
                                        ],
                                        "free_cancellation_until": null
                                    }
                                ]
                            },
                            {
                                "type": "hotel_info_price",
                                "title": "Priceline",
                                "price": 91,
                                "currency": "USD",
                                "url": "https://www.priceline.com/r/?channel=meta&product=hotel&theme=ghalistings&refid=PLGOOGLEMSS&refclickid=US_HP%7C3850305_localuniversal_1%7C20210525%7Cdesktop%7Cdefaultdate%7Cpublic%7C%7C%7C1%7C2%7C0%7C0&hotelid=3850305&checkin=20210525&checkout=20210526&rooms=1¤cy=USD&displayedCurr=USD&pOSCountryCode=US&taxDisplayMode=BP&cityid=3000002533&adults=2&land=L&metaid=AQ4IyJu_1dhNafoWk3dtxokLmsNOmpJsEsccgnegzgZFuZRbiZtsVZBU1PkudCunQv5EBubTEw1Ny8HNp6LF6WzZaE8CaPFTqOGD1PFrJyRXjelowXNF-A-ZTfx0axj3_JDHA8BzkRykI4qDtwN6jbsw9z0xngUUdL-rZ2826lQGo8LqxWJontlO4OBEJANLyOJAiJDDWgUCwpFMz_13eyUgpe2_vGSTsgolwbHO6x83RwsfYsHgN0U68HlcaMVs&dblcnt=true&user_num_adults=2",
                                "domain": "www.priceline.com",
                                "is_paid": false,
                                "free_cancellation_until": null,
                                "offers": null
                            },
                            {
                                "type": "hotel_info_price",
                                "title": "Agoda",
                                "price": 91,
                                "currency": "USD",
                                "url": "https://www.agoda.com/partners/partnersearch.aspx?site_id=1731665&CkInDay=25&CkInMonth=05&CkInYear=2021&CkOutDay=26&campaignid=&CkOutMonth=05&CkOutYear=2021&SearchDateType=default&NumberOfAdults=2<=1&NumberOfChildren=0&childages=&NumberOfRooms=1&gsite=localuniversal&los=1&PartnerCurrency=USD&hid=679639&RoomID=3008150&PriceTax=123.77&PriceTotal=214.77&RatePlan=d14ff656-5f64-c75b-3c80-2488610d9eb2&UserCountry=US&Currency=USD&UserDevice=desktop&Verif=false&rr=&audience_list=&mcid=3038&booking_source=cpc&adType=0",
                                "domain": "www.agoda.com",
                                "is_paid": false,
                                "free_cancellation_until": null,
                                "offers": null
                            },
                            {
                                "type": "hotel_info_price",
                                "title": "Tripadvisor.com",
                                "price": 91,
                                "currency": "USD",
                                "url": "https://www.tripadvisor.com/Hotel_Review-s1-?geo=1&detail=82829&m=66081&staydates=2021_05_25_2021_05_26&uguests=1_2&supdv=desktop&supbl=localuniversal&supkl=default&supuc=US&supul=en&supia=0&supip=0&supmb=&supmc=xbr2MCO9M6dsSx2MABQCxBRh1ricQaWMxp4vC-32XxXsoZ8V-uhpU48-0HCKPV7hihtPRDseH7vaY-t_8qEvsuSdff2x1HbLy0hj-pl__NnAxoPl5EIWAyTnBvqR65ErEbt5Zk1JYQ4nCoRy88A&supts=jkiI5q5Aa7rPuwZiABQCxBRh1ricQaWMxp4vC-32XxXsoUInCbSoHI5xZzZy5Y5Ib69zmZfc9kW_CZzHzezw7gXRcNtrhdCTduPvRKdyNdyldmBbXgxnqkRm20gO0AJT6rShVLHoXCijZly9YJiHe1YxiVUl1rxb_ig1uLenjb8F&supey=m%7C111939%7CPL_G_query&supcd=&suptp=CJus9t_rlub_jkIRABQCxBRh1ricQaWMxp4vC-32XxXsoXvklfs_oTFWAi9ms7zCdCiq_6DuCrQ-tlv-JaZfS_zWgcVdTPK5mbmSk-O9L0Rrvp6n7bxXo5I6iuu0dyM9eX59nt3wcUb5LasP5ZTa6RqokbNbTieSxTl_NTwwm-qlt2U",
                                "domain": "www.tripadvisor.com",
                                "is_paid": false,
                                "free_cancellation_until": null,
                                "offers": null
                            }
                        ]
                    }
                }
            ]
        }
    ]
}

Description of the fields for sending a request:

Field name Type Description
id string task identifier
unique task identifier in our system in the UUID format
you will be able to use it within 30 days to request the results of the task at any time

‌‌‌‌
‌‌As a response of the API server, you will receive JSON-encoded data containing a tasks array with the information specific to the set tasks.

You can also get all available SERP features by making a request to the following Sandbox URL:
https://sandbox.dataforseo.com/v3/business_data/google/hotel_info/task_get/advanced/00000000-0000-0000-0000-000000000000
The response will include all available items in the Google Hotel Info Advanced endpoint with the fields containing dummy data.
You won’t be charged for using Sandbox endpoints.

Description of the fields in the results array:

Field name Type Description
version string the current version of the API
status_code integer general status code
you can find the full list of the response codes here
Note: we strongly recommend designing a necessary system for handling related exceptional or error conditions
status_message string general informational message
you can find the full list of general informational messages here
time string execution time, seconds
cost float total tasks cost, USD
tasks_count integer the number of tasks in the tasks array
tasks_error integer the number of tasks in the tasks array that were returned an error
tasks array array of tasks
        id string task identifier
unique task identifier in our system in the UUID format
        status_code integer status code of the task
generated by DataForSEO; can be within the following range: 10000-60000
you can find the full list of the response codes here
        status_message string informational message of the task
you can find the full list of general informational messages here
        time string execution time, seconds
        cost float cost of the task, USD
        result_count integer number of elements in the result array
        path array URL path
        data object contains the same parameters that you specified in the POST request
        result array array of results
            hotel_identifier string unique hotel identifier
this field will contain the hotel_identifier parameter;
example:
CgoI-KWyzenM_MV3EAE
            location_code integer location code in a POST array
            language_code string language code in a POST array
            check_url string direct URL to search engine results
you can use it to make sure that we provided accurate results
            datetime string date and time when the result was received
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00
            title string hotel title
the title of the hotel entity for which the results are collected
            stars integer hotel class rating
class rating that ranges between 1-5 stars and displayed after review ratings in hotel summary
            stars_description string hotel class rating
class rating that ranges between 1-5 stars and displayed after review ratings in the hotel summary
            address string hotel address
physical address of the hotel
            phone string hotel phone number
contact phone number of the hotel
            about object information about the hotel
                description string description of the hotel
the description of the hotel entity for which the results are collected
                sub_descriptions array additional description of the hotel
details about the hotel provided in addition to the description
                check_in_time object hotel check-in time
check-in time indicated in the hotel listing
                    hour integer check-in hour
                    minute integer check-in minute
                check_out_time object hotel check-out time
check-out time indicated in the hotel listing
                    hour integer check-out hour
                    minute integer check-out minute
                full_address string full address of the hotel
address of the hotel indicated in the standardised format
                domain string hotel domain
domain of the hotel’s website
                url string hotel url
URL to the hotel’s website indicated in the listing
                amenities array hotel amenities
information about hotel amenities
                    category string standardised category of the ammenity
                    category_label string label of the category
                    items array specific amenities and details
                        amenity string standardised amenity name
                        amenity_label string displayed amenity name
                        hint string standardised details about the amenity
                        hint_label string displayed details about the amenity
                popular_amenities array hotel amenities
information about hotel amenities labelled as “popular”
                    amenity string standardised amenity name
                    amenity_label string displayed amenity name
                    hint string standardised details about the amenity
                    hint_label string displayed details about the amenity
            location object information about the hotel location
information about the location where the hotel is located
                neighborhood string name of the neighborhood where the hotel is located
                neighborhood_description string description of the neighborhood where the hotel is located
                maps_url string url to the location of the hotel in google maps
                overall_score float overall score of the hotel location
indicates the overall score of the hotel’s location in the range from 1 to 5;
calculated based on data from the hotel’s proximity to nearby things to do and restaurants, transportation, and airports;
note that the criteria are not weighted equally in the overall score
                score_by_categories object category scores of the hotel location
the scores of the hotel’s location tied to the categories that indicate the proximity to nearby things to do, restaurants, transportation, and airports;
                    overall float overall score of the hotel location
indicates the overall score of the hotel’s location in the range from 1 to 5;
calculated based on data from the hotel’s proximity to nearby things to do and restaurants, transportation, and airports;
note that the criteria are not weighted equally in the overall score
                    things_to_do float score relative to nearby things to do
indicates the score of the hotel’s location in the range from 1 to 5;
calculated based on data from the hotel’s proximity to nearby things to do
                    restaurants float score relative to nearby restaurants
indicates the score of the hotel’s location in the range from 1 to 5;
calculated based on data from the hotel’s proximity to nearby restaurants
                    transit float score relative to nearby transit options
indicates the score of the hotel’s location in the range from 1 to 5;
calculated based on data from the hotel’s proximity to nearby transit options
                    airport_access float score relative to nearby airports
indicates the score of the hotel’s location in the range from 1 to 5;
calculated based on data from the hotel’s proximity to nearby airports
                latitude float hotel latitude
latitude coordinates of the hotel’s location
example:
39.4806397
                longitude float hotel longitude
latitude coordinates of the hotel’s location
example:
-106.0512973
                location_chain array elements of the location chain
additional parameters of each element of the location chain
                    card_id string card identifier
                    feature_id string feature identifier
learn more about the identifier in this help center article
                    cid string client id
learn more about the identifier in this help center article
                    title string title of the element in the location chain
            reviews object hotel reviews by criteria
information about reviews of the hotel entity
                value float overall hotel rating based on customer votes
                votes_count integer number of customer votes
the number of customer votes included in the calculation of the hotel rating
                mentions array hotel mentions
information about hotel reviews by criteria
                    title string title of the evaluated criterion
                    positive_score float positive score by criterion
                    positive_count integer count of positive reviews by criterion
                    negative_count integer count of negative reviews by criterion
                    total_count integer count of all reviews by criterion
                    visible_by_default boolean element is visible by default
indicates whether the review element is visible by default
                rating_distribution object rating distribution by votes
the distribution of votes across the rating in the range from 1 to 5
                    5 integer votes for the 5-points rating
                    4 integer votes for the 4-points rating
                    3 integer votes for the 3-points rating
                    2 integer votes for the 2-points rating
                    1 integer votes for the 1-point rating
                other_sites_reviews array reviews on third-party sites
reviews from third-paty sites
                    title string review title
contains a name of the third-party site where review initially appeared
                    url string review url
URL to the a third-party site where review initially appeared
                    review_text string review text
text of the review
                    rating object rating in the review
information about the rating enclosed in the review on a third-party site
                        rating_type string rating type
the type of rating enclosed in the review
possible values: CustomMax, Max5
                        value float rating value
value of the rating enclosed in the review
possible values:
CustomMax – value in the range from 1 to 10
Max5 – value in the range from 1 to 5
                        votes_count integer votes count
the number of votes enclosed in the review
                        rating_max integer maximal value of the rating
the maximal value for the rating_type
            overview_images array images displayed in the hotel overview
array containing URLs to images displayed in the hotel overview
            prices object pricing details of the hotel entity
contains information about the hotel’s prices
                price integer current price per night
the price of the stay in the hotel per night
                price_without_discount integer price without discount
the price of the stay in the hotel per night, with no discount applied
                currency string price currency
USD is applied by default, unless specified in the POST array
                discount_text string text of the discount
                check_in string check-in date and tine
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00
                check_out string check-out date and tine
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example:
2019-11-15 12:57:46 +00:00
                visitors integer number of visitors
                items array array of items
array containing pricing details from third-party websites;
possible item types: hotel_info_price
                    type string type = ‘hotel_info_price’
                    title string title of the item
includes the name of the third-party website with pricing information
                    price integer price per night
price per night indicated on a third-patry website
                    currency integer price currency
currency of a price indicated on a third-patry website
                    url string third-party page url
URL to the third-party website page with pricing information
                    domain string third-party domain
domain of the third-party website page with pricing information
                    is_paid boolean indicates a paid booking link
if true, related hotel_info_price item is a hotel ad
if false, related hotel_info_price item is a free booking link
                    free_cancellation_until string date until which free cancellation is available
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
equals null if free cancellation is not available for the selected dates
                    offers array featured price offers
                        type string type = ‘hotel_info_price_offer’
                        title string title of the price offer
                        price integer value of the price offer
                        currency string currency of the price offer
                        url string url of the price offer
URL to the page of the website where price offer appears
                        max_visitors integer the maximal number of visitors
the maximum number of visitors for which the price offer is valid
                        offer_images array price offer images
URLs of the images featured in the price offer
                        free_cancellation_until string date until free cancellation is available
in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
equals null if free cancellation is not available for the selected dates

‌‌